8.1.2 创建法币支付订单

#简要描述： 获取现金（法币）支付（充值）订单

• 请求方式: POST
• 请求接口: https://网关域名/wallet-trade-merchant/v1/receive/cash/payment/create
• 请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	平台分配商户 key
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
channelCode	string	是	渠道编码	通过文档8.1.1接口获取渠道编码（channelCode字段）
currency	string	是	币种	订单计价币种
amount	number	是	金额	订单计价金额
localUserRealName	string	否	本地用户真实姓名
sign	string	是	签名	详情见签名算法

请求 json 样例

{
 "key": "dNNTJZpgFVWlYrVv",
 "localOrderId": "conantest344",
 "localUserId": "conan",
 "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
 "isBlockchain": true,
 "channelCode":"tencentest9",
 "currency": "CNY",
 "amount": "100",
 "localUserRealName":"柯南",
 "sign": "9662c0f104123b0ccac049108f174589"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
           "orderId": 352950471221317,
           "localOrderId": "conantest344",
           "uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
           }
}

响应data 参数说明

参数名称	类型	参数含义	参数说明
orderId	long	订单ID
localOrderId	string	商户平台本地订单号
luiUrl	string	支付链接地址

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例

{
 "amount":"100",
 "currency":"CNY",
 "localOrderId":"conantest344",
 "merchantId":302992856974,
 "merchantUserId":"conan",
 "notifyTime":1757577957437,
 "orderCreateTime":1757577574425,
 "orderId":"352950471221317",
 "paidAmount":"100",
 "status":"SUCCESS",
 "type":"PAYMENT",
 "sign":"774720acbacafca99af62b98d72154d3",
 "key":"9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
currency	string	是	币种
localOrderId	string	是	商户本地订单号
merchantId	string	是	商户ID
merchantUserId	string	是	商户平台本地用户ID
notifyTime	long	是	回调时间	毫秒
orderCreateTime	long	是	订单创建时间	毫秒
orderId	string	是	订单号
paidAmount	decimal	是	支付金额
status	string	是	订单状态	SUCCESS:已完成 | FAIL:已失败
type	string	是	订单类型	PAYMENT支付、WITHDRAW 提款
sign	string	否	md5 签名	详情看签名算法
key	string	是	商户 key

如果您接受到了回调信息，只需要返回success，即表示消息已处理，本条回调不再会发送，否则会尝试重复发送直到获得期望的响应， 目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s，都无响应后，不再重复发送。